home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / zcomd506.arc / ZCOMMDOC.AE < prev    next >
Text File  |  1991-05-06  |  79KB  |  1,771 lines

  1.  
  2.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  3.         ZCOMM User Manual                                                  121
  4.  
  5.           N.B.: Backslashes in file names used with the obey command must be
  6.           escaped.
  7.           N.B.: When the obey command is used to substitute file names, file
  8.           names containing separator or operator characters such as & may
  9.           change the syntax of the resulting command.  For instance, the
  10.           pathological but legal DOS filename foo&&999.bar would cause obey if
  11.           f%thisfile gosub dofile to expand to if ffoo&&999.bar gosub dofile
  12.           to parse as a test for a match to an illegal pattern 999.
  13.  
  14.         off Disable the modem by dropping DTR (Data Terminal Ready), [14]
  15.           release ownership of the serial port, and exit to the operating
  16.           system.  DOS ZCOMM drops Clear To Send (CTS) as well as DTR if
  17.           hardware flow control was selected with the handshake command.
  18.  
  19.           Exit status is the value of the ?  numeric parameter.
  20.  
  21.           The next program must select the port and initialize it to reassert
  22.           DTR before making or answering another data call.
  23.  
  24.           SEE ALSO: bye, x, o, port commands
  25.  
  26.         on [condition rest-of-line] * Executes rest-of-line if condition is
  27.           true.  Condition is tested after each command line executes, unless
  28.           a return or fail command is executed, or when pattern is the last
  29.           command on the line.  An on command without predicate (on a line by
  30.           itself) cancels the on command active at that script level.
  31.  
  32.           EXAMPLE: on
  33.  
  34.           The term function may be accessed with the wait command and no
  35.           patterns active to force an exit on loss of carrier detect or
  36.           pattern search timeout.  Otherwise, ZCOMM could remain in term
  37.           function until a command is keyboarded.  Typical commands to use
  38.           with the on statement are goto, return, off, and abort.  Chapter 27
  39.           describes the testable conditions.
  40.  
  41.           One active on statement is available for each level of script.  The
  42.           on statement does not propagate to succeeding script levels.
  43.  
  44.           When rest-of-line is executed, the on statement at that level is
  45.           canceled.  An on command cancels any previous on command at that
  46.           script level.
  47.  
  48.           EXAMPLE: on !c goto fooend Branches to fooend if the carrier drops
  49.           out.
  50.  
  51.  
  52.         __________
  53.  
  54.         14. The modem must be configured to use Data Terminal Ready (DTR).
  55.  
  56.  
  57.  
  58.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  59.  
  60.  
  61.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  62.         ZCOMM User Manual                                                  122
  63.  
  64.           SEE ALSO: wait, if commands
  65.           NB: No other commands may be on the line after the on command except
  66.           for its predicate.
  67.  
  68.         open [-modes] file Opens file for transmission with the term function
  69.           with modes.  The open command should be used when you don't want to
  70.           enter the term function immediately, or are already in it.  In other
  71.           situations, it may be necessary to open the file before dialing to
  72.           allow transmission immediately after connection, without the delay
  73.           of opening the file from a floppy disk.
  74.  
  75.           SEE ALSO: seek, read, close commands
  76.  
  77.         page pathspec Type the file(s) specified in pathspec a screenfull at a
  78.           time.  When the screen is filled up, the More?  prompt appears.
  79.           Typing space displays another screenfull.  Typing ^X skips to the
  80.           next file.  Typing ^K or ^C terminates the command.  This command
  81.           closes any open transmit file.  ZCOMM automatically detects SQueezed
  82.           files and prints them in ASCII.*
  83.  
  84.           EXAMPLE: page *.doc
  85.  
  86.  
  87.           SEE ALSO: browse, type, list, findmore commands
  88.  
  89.         PATtern [n[cilpv$] string [action]] (n = 0...24) The pattern command
  90.           allows ZCOMM to search for up to 25 different responses from a
  91.           remote computer, and take action based on which of those responses
  92.           (or none) was "seen".  A pattern match can execute specified script
  93.           command(s) "on the fly" (c modifier) or return control to the
  94.           calling script with an indication of which pattern was matched.
  95.  
  96.           The pattern command causes the next t, f, or wait command (term
  97.           function) to search for string in the data received from the
  98.           remote/modem.  String must be entered exactly as it will be received
  99.           from the modem, in the same case and with the same embedded spaces
  100.           or tabs.  Control characters must be represented with ZCOMM
  101.           character escapes.  The metacharacter \256 matches any single
  102.           character.  ZCOMM %string substitutions may be used to define search
  103.           patterns.  If the % character is to be searched for, it must be
  104.           represented as \045.
  105.  
  106.           Parity, NULL, RUBOUT, XON, and XOFF characters received from the
  107.           remote do not affect pattern searches.  If Kermit AutoDownload (K
  108.           mode) is set, strings with SOH (Ctrl-A) cannot be matched.  If
  109.           ZMODEM AutoDownload (Z mode) is set, strings with CAN (Ctrl-Z)
  110.           cannot be matched.  If B protocol (c mode) is set, strings with DLE
  111.           or ENQ cannot be matched.
  112.  
  113.           Strings of up to 33 characters each may be specified for
  114.           simultaneous search by the term function.  The search patterns are
  115.  
  116.  
  117.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  118.  
  119.  
  120.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  121.         ZCOMM User Manual                                                  123
  122.  
  123.           "global" among all script levels; a pattern command in a subroutine
  124.           affects the patterns set by the calling script(s) and vice versa.
  125.  
  126.           The term function returns when one of the patterns is matched or
  127.           when the term function times out with f seconds with no characters
  128.           from the remote, as determined by the f numeric parameter, or when
  129.           carrier detect is lost.  The first wait, t or f command given after
  130.           the pattern command begins the search.
  131.  
  132.           When one of the patterns is matched, that pattern is marked as found
  133.           and its corresponding action is executed (if present).  ZCOMM will
  134.           remain in the term function until there is a pause in data
  135.           transmission from the remote[15] unless the i or c modifier is used.
  136.  
  137.           The following modifiers may be used.  The c, i, and l modifiers are
  138.           mutually exclusive.
  139.  
  140.           c     The pattern is marked as found and action executed (if
  141.                 present).  The term function then continues searching.
  142.                 Matching this pattern does not cause a return from the term
  143.                 function.  The condition for this pattern will test true, but
  144.                 the n test condition is not affected.
  145.  
  146.           i (Immediate) The pattern is marked as found and action executed (if
  147.                 present).  The term function then returns immediately.
  148.  
  149.           l (line end delay) The pattern is marked as found and action
  150.                 executed (if present).  The term function then returns after
  151.                 the first LF character following the matched string.
  152.  
  153.           p (permanent) A pattern with the p modifier is not reset by the
  154.                 pattern command without arguments.  Patterns with the p
  155.                 modifier may be used to search for disconnect messages within
  156.                 an entire script.  Permanent patterns are reset by the call
  157.                 command, each item in the outcall queue, and an explicit
  158.                 pattern command referencing that particular pattern number.
  159.  
  160.                 EXAMPLE: pattern 20 "\nCLR" "@off" Disconnects and exits ZCOMM
  161.                 if the phrase CLR is seen immediately following an LF.
  162.  
  163.  
  164.           v (verbose) The v modifier displays a message when the pattern is
  165.                 matched.  This is often useful when debugging scripts when the
  166.                 large amount of output generated by large v numeric parameter
  167.                 values is not desired.
  168.  
  169.  
  170.         __________
  171.  
  172.         15. Pause length is specified by the q numeric parameter.
  173.  
  174.  
  175.  
  176.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  177.  
  178.  
  179.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  180.         ZCOMM User Manual                                                  124
  181.  
  182.                 EXAMPLE: pat 5v "Finished Already."
  183.  
  184.  
  185.           $     Sometimes the only way to recognize a prompt (as distinct from
  186.                 the same string embedded in other data) is to require the
  187.                 prompt to be the last thing sent by the remote, before a
  188.                 pause.  The $ modifier allows string to be matched only if the
  189.                 remote pauses for 1 to 2 seconds after transmitting the last
  190.                 character in string.
  191.  
  192.           The optional action is a string to be sent to the remote, or
  193.           executed as a command if it begins with "@".  Action is executed the
  194.           instant the last character of the pattern is matched, even if the i
  195.           modifier is not used.  Action must not use the goto, f, t, or wait
  196.           commands.
  197.  
  198.           The pattern command without any arguments clears the patterns that
  199.           don't have the p modifier, and terminates pattern searching.  The
  200.           other events that terminate pattern search are a match to a pattern
  201.           that does not have the c modifier, a pattern search timeout, the
  202.           call, abort, or quit commands, a major error, or the NUKE key.
  203.  
  204.           EXAMPLE: pat 0c$ "" "\21"
  205.           Sends one XON character every time there is a pause in output from
  206.           the remote.  This recovers from situations where the remote computer
  207.           stops because it receiveed a spurious XOFF character, or lost an XON
  208.           character.
  209.  
  210.  
  211.           In the pattern n string command, if string contains a repeating
  212.           sequence such as foo in foofoobar, the search may be unsuccessful if
  213.           part of the phrase is received immediately prior to the desired
  214.           string (foofoofoobar).
  215.  
  216.         port n Change the modem port to COMn.  On DOS, the legal values for n
  217.           are 1...18.
  218.  
  219.           Selecting a new port normally selects software handshaking
  220.           ("handshake sw").  The PCDOS flavor enables both hardware and
  221.           software handshaking ("handshake both") iff the port speed exceeds
  222.           2400 bps and the Clear To Send (CTS) signal is active at the time
  223.           the port command is given.
  224.  
  225.           Standard Ports (PCDOS):
  226.           COM1 3F8 IRQ4 (Standard IBM)
  227.           COM2 2F8 IRQ3 (Standard IBM)
  228.  
  229.           NON STANDARD PORTS:
  230.           COM3 3E8 IRQ4 (Alternate)
  231.           COM4 2E8 IRQ3 (Alternate)
  232.           COM5 2B8 IRQ3 (Columbia)
  233.  
  234.  
  235.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  236.  
  237.  
  238.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  239.         ZCOMM User Manual                                                  125
  240.  
  241.           COM6 2B8 IRQ2 (Alternate for IBM)
  242.  
  243.           COM7 2E8 IRQ5 (Alternate "COM3")
  244.           COM8 3E8 IRQ5 (Alternate "COM4")
  245.  
  246.           COM9 Uses the port address and interrupt vector previously set by
  247.           the portx command.
  248.           COM11-COM18 IBM PS/2 COM1-COM8 ports
  249.  
  250.           COM1 and COM2 are the standard serial ports defined by the IBM
  251.           Technical Reference Manual.
  252.  
  253.           COM3 and COM4 are supported by many serial cards and modem boards.
  254.           COM3 and COM1 share the same dedicated hardware interrupt line, and
  255.           these ports may not be used at the same time.  Likewise, COM4 and
  256.           COM2 may not be used at the same time.
  257.  
  258.           Columbia computers support COM5.
  259.  
  260.           COM6 to COM8 are alternate configurations that may be accessed by
  261.           cross jumpering between printer port decoders and serial port
  262.           enables on some multifunction boards.
  263.  
  264.           COM7 and COM8 support alternative definitions for "COM3" and "COM4"
  265.           respectively.
  266.  
  267.           COM11 to COM18 correspond to "COM1" to "COM8" on IBM PS/2 computers.
  268.           Only one of COM12-COM18 may be used at a time unless using the
  269.           special OS/2 comm driver for that board.
  270.  
  271.           Since ZCOMM uses the interrupt line on the selected port, no other
  272.           program or device driver may use the same port address and/or
  273.           interrupt vector concurrently.  Certain disk controllers and mice
  274.           interfaces use IRQ2 and IRQ5.  Do not use IRQ2 on a PC-AT (the extra
  275.           8259 is not reset).  IRQ5 is sometimes used by network cards and
  276.           printer ports.  Do not select COM3 to COM18 unless you are familiar
  277.           with the I/O addresses and interrupt vectors used in your machine.
  278.           Ports sharing the same interrupt vector (IRQ number) cannot be used
  279.           concurrently.
  280.  
  281.           The port command sets the d mode (which suppress the No Carrier
  282.           Detect message).
  283.  
  284.           EXAMPLE: port 2
  285.  
  286.  
  287.           DOS ZCOMM begins with COM1 unless overridden by the DPORT
  288.           environment variable.
  289.  
  290.           EXAMPLE: C>set DPORT=2
  291.  
  292.  
  293.  
  294.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  295.  
  296.  
  297.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  298.         ZCOMM User Manual                                                  126
  299.  
  300.           On Unix, the argument of the port command is a character special
  301.           file in the /dev directory.  Unix and Xenix flavors have no default
  302.           port.  If the DPORT environment variable is set, that port will be
  303.           selected when ZCOMM initializes.  Otherwise, a port is selected by
  304.           the startup and/or dialing script.  Typical values are tty01
  305.           (386/ix) and tty2A (Xenix).
  306.  
  307.           EXAMPLE: DPORT=tty1A; export DPORT
  308.  
  309.  
  310.           SEE ALSO: handshake command, dport string parameter
  311.  
  312.         portx hbase,irq * To support specialized multiport serial interfaces,
  313.           the portx command selects a communications port with a specified
  314.           hexadecimal base address hbase and Interrupt Request Line irq (3 <=
  315.           irq <= 7).  The portx does not check its argument for validity.  The
  316.           consequences of an invalid selection are quite undefined.  The
  317.           specified base address and IRQ number are assigned to COM9, where
  318.           they may be used by the port command and the x numeric parameter.
  319.           The status line and s command will indicate COM9.  This command not
  320.           available on X.PC, Unix, Xenix, or OS/2.
  321.  
  322.           EXAMPLE: portx 3f8,4 Selects a comm port with a base address of 3f8,
  323.           using IRQ4.
  324.  
  325.  
  326.           SEE ALSO: intolink string parameter
  327.  
  328.         private The private command allows a caller to keyboard a message
  329.           which will be appended to a file specified by the private string
  330.           parameter.  Typically, private points to a private file inaccessible
  331.           to callers.  ZCOMM prepends a "From" line using the callers name as
  332.           stored in the remote string parameter.  The private command prompts
  333.           the caller to keyboard a "to:" name and up to 64 lines of text.  A
  334.           blank line terminates the message.  This command is intended for
  335.           short messages; long messages should be uploaded with a file
  336.           transfer protocol.  Keyboarding is controlled by the Z numeric
  337.           parameter, which sets the hot zone column after which a keyboarded
  338.           space character begins a new line.
  339.  
  340.           SEE ALSO: message command
  341.  
  342.         purgek Purge any characters the user may have typed ahead.*
  343.  
  344.         purgel Purge any unprocessed characters received from the modem Line
  345.           (remote).*
  346.  
  347.         put string The put command transmits string to the remote.  Use the
  348.           put command for transmitting commands to a modem or a remote
  349.           computer system.  String is processed for character escapes.
  350.           Control and other special characters may be entered with character
  351.  
  352.  
  353.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  354.  
  355.  
  356.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  357.         ZCOMM User Manual                                                  127
  358.  
  359.           escapes described in Chapter 26.  If a carriage return should be
  360.           sent, it must be explicitly coded with \r at the end of the string.
  361.  
  362.           EXAMPLE: put "myname\r" Sends myname followed by carriage return to
  363.           the modem.
  364.  
  365.  
  366.           A \336 (octal 336) character causes a pause in transmission
  367.           (duration controlled by the p numeric parameter).  This pause allows
  368.           one string to contain multiple commands.
  369.  
  370.           EXAMPLE: put "\336ATZ\r\336\336ATX1 M0 S0=1\r" Pauses, sends ATZ\r,
  371.           pauses (twice because some modems take longer to reset!), and then
  372.           sends ATX1 etc. to the modem.
  373.  
  374.  
  375.           Transmission with put is controlled by the 7, 8, h, p, w, and t
  376.           modes.
  377.  
  378.           SEE ALSO: putw, mput, putv commands
  379.  
  380.         putw string The putw command transmits string to the remote, and
  381.           pauses for a period of time (determined by the q numeric parameter)
  382.           before returning from the term function to allow characters to echo.
  383.           Other than that final pause, putw operates the same as the put
  384.           command.
  385.           N.B.: Putw should not be used when the next operation will be a
  386.           pattern or wait command.  If the expected response starts before the
  387.           putw command finishes, the following wait command will never get to
  388.           "see" what it is waiting for.  In general, the putw command should
  389.           only be used as a short-cut for sending a command when the response
  390.           is known in advance and can be safely ignored.
  391.  
  392.           SEE ALSO: put, mput commands
  393.  
  394.         putv svar The putv command transmits svar to the remote without any
  395.           translation of character escapes.  Putv does not append a carriage
  396.           return or line feed to the transmitted string.
  397.  
  398.           EXAMPLE: putv s0; put "\r"
  399.  
  400.  
  401.           SEE ALSO: put, mput commands
  402.  
  403.         pwd Print Working Directory displays the current directory pathname,
  404.           and stores it in the pwd string parameter.
  405.  
  406.           EXAMPLE: pwd
  407.  
  408.  
  409.           SEE ALSO: cd command
  410.  
  411.  
  412.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  413.  
  414.  
  415.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  416.         ZCOMM User Manual                                                  128
  417.  
  418.         pxN Set Numeric parameter x to value N.  If x and N are blank, display
  419.           the numeric parameters which can be set by this command and their
  420.           current values.  This command is not allowed if Restricted.  Numeric
  421.           parameters are described in Chapter 24.
  422.  
  423.           EXAMPLE: ps8 Sets the status line attribute to 8 (grey), suitable
  424.           for composite video displays.
  425.  
  426.  
  427.           EXAMPLE: pv-1 Sets the v numeric parameter ("verbose") to -1,
  428.           suppressing some routine messages.  More negative values suppress
  429.           more routine messages.
  430.  
  431.  
  432.           EXAMPLE: pd1 Sets the d numeric parameter to 1, causing files
  433.           received with ZMODEM or full YMODEM protocol to be stored with the
  434.           modification date transmitted with the file.
  435.  
  436.  
  437.           EXAMPLE: pk3 Sets the k numeric parameter to 3, which kills pending
  438.           output stored in the circular buffer when ETX (Ctrl-C) (decimal 3)
  439.           is keyboarded in the term function.
  440.  
  441.  
  442.         queue { add [string] | clear | delete [n] | list | run } Manipulate
  443.           and execute a queue of commands for dialing numbers or other
  444.           suitable functions.  The queue contains 20 slots numbered 0 to 19.
  445.  
  446.           queue clear clears all queue entries.
  447.  
  448.           queue add [string] adds string to the queue after processing for
  449.                string substitutions.  The string is added to the first empty
  450.                queue slot available.  If string is absent, it is taken from
  451.                the next script line.  A typical string would be a command to
  452.                call a system: call telegodzilla
  453.  
  454.                Script entries used with the circular dialing queue should end
  455.                with a t command, which will enter the term function.  To stop
  456.                the queue at that point, use the ALT-N (NUKE) key.  NUKE
  457.  
  458.           queue delete [n] Delete then nth queue entry, or the currently
  459.                executing entry if n is not present.
  460.  
  461.           queue list lists the non empty queue entries.
  462.  
  463.           queue run begins execution of the queue entries.  The ALT-N (NUKE)
  464.                key, a fatal errror or any keyboarded character present after
  465.                the execution of the command in the entry terminates the queue
  466.                run command.
  467.           The queue commands are independent of the Outcall Queue available in
  468.           Host Operation.
  469.  
  470.  
  471.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  472.  
  473.  
  474.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  475.         ZCOMM User Manual                                                  129
  476.  
  477.           EXAMPLE: The script fragment:
  478.                queue clear
  479.                while q set? s0 Q queue add "echo %s0"
  480.                queue list
  481.  
  482.           Sets each queue entry to echo its own queue number, then lists the
  483.           queue entries.
  484.  
  485.  
  486.           SEE ALSO: q and Q test conditions, Shift-F5 and Shift-F6 function
  487.           keys
  488.  
  489.         quit * Causes an immediate return to the command prompt from any
  490.           script level.  Quit may be used within a command string assigned to
  491.           a function key where an unconditional return to the command prompt
  492.           is desired, even if keyboarded from the term function.
  493.  
  494.         r [oldcmd] Search back through the history file of keyboarded lines
  495.           for the first line that oldcmd is a prefix of, and execute it.  If
  496.           oldcmd is absent, execute the last locall entered keyboarded line.
  497.  
  498.           EXAMPLE: history C:/tmp/junk.hst
  499.                del *.bak *.lst *.tmp *.foo
  500.                cd bazdir
  501.                r d
  502.                del *.bak *.lst *.tmp *.foo (command echoes)
  503.  
  504.  
  505.           SEE ALSO: history command
  506.  
  507.         r7 [-options] [dir] [file ...] Receives with options 1 or more files
  508.           using MODEM7 batch protocol.  An optional directory dir may be
  509.           specified.  If pathname(s) have been supplied to the r7 command and
  510.           the sending program attempts to send more files than the number of
  511.           names supplied to the r7 command, the transfer is aborted.  The
  512.           command is provided for compatibility with traditional programs that
  513.           do not support the superior YMODEM or ZMODEM protocols.
  514.  
  515.           EXAMPLE: r7 -c Receive file(s) with MODEM7 Batch and CRC-16 (-c).
  516.  
  517.  
  518.           SEE ALSO: MODEM7 batch protocol, Chapter 13.
  519.  
  520.         rb [-options] Receives with options 1 or more files using YMODEM batch
  521.           protocol.  The rb command also receives files sent with SEAlink
  522.           protocol.  Chapter 20 describes the available options.  The pathname
  523.           and length of each file are transmitted in batch mode.  If a file is
  524.           received in error (retries exhausted, etc.), the batch transfer will
  525.           terminate.  If Restricted, a file received in error will be unlinked
  526.           (erased).
  527.  
  528.  
  529.  
  530.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  531.  
  532.  
  533.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  534.         ZCOMM User Manual                                                  130
  535.  
  536.           EXAMPLE: rb -y Receive file(s) with YMODEM replacing old files, if
  537.           any.
  538.  
  539.  
  540.           EXAMPLE: rb -g Receive file(s) with YMODEM-g.
  541.  
  542.           Many programs claiming to support YMODEM actually use XMODEM with
  543.           1024 byte blocks; use ZCOMM's sx -k, rx and rx -g XMODEM commands
  544.           with these mutants.
  545.  
  546.           SEE ALSO: YMODEM protocol, Chapter 13.
  547.  
  548.         rb [-options] [dir] [file ...] Receives with options 1 or more files
  549.           using YMODEM batch protocol.  An optional disk and/or directory dir
  550.           may be specified.  The optional supplied pathnames file ...  are
  551.           used in place of pathnames normally provided by the sending program.
  552.           If the sending program attempts to send more files than the number
  553.           of names supplied to the rb command, the transfer is aborted.
  554.  
  555.         rc [-options] file Receives with options a single file using the Ward
  556.           Christensen XMODEM protocol, 128 or 1024 byte blocks, and CRC-16
  557.           instead of an 8 bit checksum.  ZCOMM signals the sending program
  558.           that CRC-16 is to be used.  After four errors while attempting to
  559.           receive the first sector, ZCOMM will cancel the CRC-16 option and
  560.           reverts to checksum operation.
  561.  
  562.           The probability of an undetected transmission error is much less if
  563.           CRC-16 is used in place of the default 8 bit arithmetic checksum.
  564.           Omen Technology Inc Recommends use of the 16 bit CRC to maintain
  565.           data integrity at professional levels.  Chapter 20 describes the
  566.           available options to the rc command.  If Restricted, a file received
  567.           in error will be deleted.
  568.  
  569.           EXAMPLE: rc foo.com
  570.  
  571.  
  572.           SEE ALSO: XMODEM-CRC protocol, Chapter 13.
  573.  
  574.         read [file] Read file into the circular buffer.  Once in the buffer,
  575.           it may be examined with the review command, searched for strings,
  576.           and cut and pasted to other files.  If file does not fit into the
  577.           buffer, the buffer may be cleared with the kill command (or review k
  578.           subcommand) and subsequent read commands may be given to read more
  579.           of it.  Review function commands are described in Chapter 23.
  580.  
  581.           EXAMPLE: read allsig.tmp<ENTER><Home>
  582.  
  583.  
  584.           SEE ALSO: BROwse, seek commands
  585.           CAUTION: Iff a read command has left a transmit file open, entering
  586.           the term function will transmit the unread portion of the file.  To
  587.  
  588.  
  589.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  590.  
  591.  
  592.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  593.         ZCOMM User Manual                                                  131
  594.  
  595.           prevent this, close the file first with ALT-C or closetx.
  596.  
  597.         receive Receives file(s) from a Kermit program.  The other program
  598.           must be commanded to send the desired files.
  599.  
  600.           SEE ALSO: get Kermit server access command
  601.  
  602.         remote Enter Host state with unrestricted privileges to allow the
  603.           currently connected remote computer/terminal to issue commands.
  604.           When activated by the remote command, Host state will reset when the
  605.           modem carrier goes away.  This command is useful for transferring
  606.           files between two machines with directly connected serial ports.
  607.           Remote may be prefixed with restrict to limit privileges.*
  608.  
  609.           SEE ALSO: host command
  610.  
  611.         remote cwd dirspec [password] Instructs the remote Kermit server to
  612.           change to the specified directory.  The form of dirspec varies with
  613.           the remote system; it must be quoted if it contains special
  614.           characters or spaces.  A password may be required by the remote
  615.           Kermit server.
  616.  
  617.           SEE ALSO: Kermit Protocol, Chapter 13.
  618.  
  619.         remote delete filespec Instructs the remote Kermit server to delete
  620.           the specified file(s).  The form of filespec varies with the remote
  621.           system; it must be quoted if it contains special characters or
  622.           spaces.
  623.  
  624.         remote dir dirspec Instructs the remote Kermit server to display the
  625.           specified directory on your screen.  The form of dirspec varies with
  626.           the remote system; it must be quoted if it contains special
  627.           characters or spaces.  The resulting information may be redirected
  628.           to a file with the >outfile command.
  629.  
  630.         remote help Instructs the remote Kermit server to display help
  631.           information on your screen.  The resulting information may be
  632.           redirected to a file with the >outfile command.
  633.  
  634.         remote host host-command-string Instructs the remote Kermit server to
  635.           perform the specified command and display its output on your screen.
  636.           The form of host-command-string varies with the remote system; it
  637.           must be quoted if it contains special characters or spaces.  The
  638.           resulting information may be redirected to a file with the >outfile
  639.           command.
  640.  
  641.           EXAMPLE: remote host "kill -9 0" Terminates all your processes with
  642.           extreme prejudice.
  643.  
  644.  
  645.           SEE ALSO: !!command
  646.  
  647.  
  648.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  649.  
  650.  
  651.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  652.         ZCOMM User Manual                                                  132
  653.  
  654.         remote print filespec Instructs the remote Kermit server to print the
  655.           specified file(s) on the remote system.  The form of filespec varies
  656.           with the remote system; it must be quoted if it contains special
  657.           characters or spaces.
  658.  
  659.         remote space [dirspec] Instructs the remote Kermit server to display
  660.           the free space in the specified directory on your screen.  The form
  661.           of dirspec varies with the remote system; it must be quoted if it
  662.           contains special characters or spaces.  The resulting information
  663.           may be redirected to a file with the >outfile command.
  664.  
  665.         remote type filespec Instructs the remote Kermit server to type the
  666.           specified file(s) on your screen.  The form of filespec varies with
  667.           the remote system; it must be quoted if it contains special
  668.           characters or spaces.  The resulting information may be redirected
  669.           to a file with the >outfile command.
  670.  
  671.         remote who Instructs the remote Kermit server to display the logged in
  672.           users on your screen.  The resulting information may be redirected
  673.           to a file with the >outfile command.
  674.  
  675.         reset Write the contents of the circular buffer if a receive file is
  676.           open, close all files, and reset the disk system.  This allows
  677.           swapping diskettes.
  678.  
  679.         reskeys Resets the Soft Keys to empty.
  680.  
  681.           SEE ALSO: set command
  682.  
  683.         restime * Resets elapsed time and counts of bytes transmitted and
  684.           received to zero.  The restime command may be given in a script
  685.           immediately after login is completed to synchronize the elapsed time
  686.           counter with the beginning of chargeable connect time.
  687.  
  688.           SEE ALSO: timestamp command, E test condition
  689.  
  690.         restrict * Restricts ZCOMM for the following command on the same line.
  691.           This command is useful for testing.
  692.  
  693.           EXAMPLE: restrict source /menu.t
  694.  
  695.  
  696.         RETurn Returns from a script subroutine accessed by a call, source, or
  697.           gosub command.
  698.  
  699.           SEE ALSO: fail command
  700.  
  701.         rewind Reset the buffer pointers for display, printer, and file output
  702.           used by the term function to the beginning of the circular buffer.
  703.           This will cause the term function to redisplay the data in the
  704.           circular buffer.  Patterns will be rescanned.  A typical use of the
  705.  
  706.  
  707.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  708.  
  709.  
  710.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  711.         ZCOMM User Manual                                                  133
  712.  
  713.           rewind function is to allow replay of an editing session on a remote
  714.           machine, or to redisplay the material received if the initial
  715.           settings of the i, c, n or v modes were incorrect for the material
  716.           received from the remote.
  717.           N.B.: The rewind command does not reset the buffer free character
  718.           count.  To write the data to disk, a write command (or ALT-W) must
  719.           be given before accepting new data from the remote.
  720.  
  721.           SEE ALSO: t, b, w review subcommands
  722.  
  723.         REView Review the data received from the host or read by the read
  724.           command.  A screenfull is displayed at a time.  Review function
  725.           commands are listed in Chapter 23.
  726.  
  727.         ro [-options] file Receives with options a single file using non-
  728.           standard XMODEM-CRC protocol logic.  OverThruster(TM) speeds file
  729.           downloads at the expense of error recovery.  OverThruster operation
  730.           is controlled by the O numeric parameter.  As fans of Buckaroo
  731.           Bonzai know, the OverThruster is not universally applicable.  A
  732.           transmission error will almost always terminate an OverThruster file
  733.           download.
  734.  
  735.           If Restricted, a file received in error will be unlinked (erased).
  736.  
  737.           EXAMPLE: ro foo.com
  738.  
  739.  
  740.           SEE ALSO: O numeric parameter
  741.  
  742.         rt [-options] [dir] [file ...] Receives with options 1 or more files
  743.           using Telink (FIDO) batch protocol.  An optional disk and/or
  744.           directory dir may be specified.  The optional supplied pathnames
  745.           file ...  are used in place of pathnames normally provided by the
  746.           sending program.  If pathname(s) have been supplied to the rt
  747.           command and the sending program attempts to send more files than the
  748.           number of names supplied to the rt command, the transfer is aborted.
  749.           The rt command is provided for compatibility with traditional
  750.           programs that do not support the superior YMODEM or ZMODEM
  751.           protocols.
  752.  
  753.           EXAMPLE: rt -c
  754.  
  755.  
  756.           SEE ALSO: Telink protocol, Chapter 13.
  757.  
  758.         rw [-options] file Receives with options a single file using the
  759.           People-Link WXMODEM protocol.  Chapter 20 describes the available
  760.           options.  If Restricted, a file received in error will be unlinked
  761.           (erased).
  762.  
  763.           EXAMPLE: rw foo.com
  764.  
  765.  
  766.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  767.  
  768.  
  769.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  770.         ZCOMM User Manual                                                  134
  771.  
  772.  
  773.  
  774.         rx [-options] file Receives with options a single file using the Ward
  775.           Christensen XMODEM protocol.  CRC-16 is not the default because most
  776.           commercial comms programs only support the 8 bit checksum.  Chapter
  777.           20 describes the available options.  If Restricted, a file received
  778.           in error will be unlinked (erased).
  779.  
  780.           EXAMPLE: rx foo.com
  781.  
  782.           N.B.: The rc command should be used whenever possible instead of rx.
  783.  
  784.           EXAMPLE: rx -g foo.txt Receive a single file with an ACKless XMODEM
  785.           protocol mutant incorrectly called "ymodem-g" by PCBoard and Qmodem
  786.           programs.
  787.  
  788.           SEE ALSO: XMODEM protocol, Chapter 13.
  789.  
  790.         rz [-options] Receives with options 1 or more files using ZMODEM batch
  791.           protocol.  Chapter 20 describes the available options.  Each file's
  792.           pathname is obtained from the sending program.  The +, a, b, n, N,
  793.           r, and y options are accepted from the sending program, subject to
  794.           Restriced privileges.  If the +, b, n, N, r, or y option is
  795.           specified to the receiver, it overrides any contrary options
  796.           specified to the sender.  Only one of the a, b, or r options may be
  797.           specified.  Only one of the +, n, N, or y options may be specified.
  798.           If a file is received in error (retries exhausted, etc.), the batch
  799.           transfer will terminate.  If Restricted, a file received in error
  800.           will be unlinked (erased).
  801.  
  802.           EXAMPLE: rz -y
  803.  
  804.  
  805.           SEE ALSO: Z mode
  806.  
  807.           SEE ALSO: ZMODEM protocol, Chapter 13.
  808.  
  809.         rz [-options] [dir] [file ...] Receives with options 1 or more files
  810.           using ZMODEM batch protocol.  An optional disk and/or directory dir
  811.           may be specified.  The optional supplied pathnames file ...  are
  812.           used in place of pathnames normally provided by the sending program.
  813.           If the sending program attempts to send more files than the number
  814.           of names supplied to the rz command, the transfer is aborted.  To
  815.           allow use of the rz command, Z mode (ZMODEM autodownload) should be
  816.           turned off with a dis -Z command.
  817.  
  818.         s Displays status information.
  819.  
  820.           LSR and MSR refer to the Line Status Register and Modem Status
  821.           Register of the modem port's 8250 UART device.
  822.  
  823.  
  824.  
  825.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  826.  
  827.  
  828.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  829.         ZCOMM User Manual                                                  135
  830.  
  831.           TYP refers to the type of serial chip detected.  A National 16550A
  832.           shows as 1, an Intel 82510 shows as 2.  Other chips (without high
  833.           speed enhancements) show as 0.
  834.  
  835.           "Uncorrected errors" displays the e numeric parameter, which counts
  836.           the number of failed file transfers and "line hits" detected by the
  837.           term function.
  838.  
  839.           If one or more scripts are active, the current line number (counting
  840.           from the first line in the script file) for each script level is
  841.           displayed.
  842.  
  843.           Any patterns active as a result of a pattern or wait command are
  844.           displayed.  An S indicates not matched (still searching), F
  845.           indicates that pattern has been matched.
  846.  
  847.  
  848.           SEE ALSO: ALT-S function key
  849.  
  850.         s7 [-options] pathspec Send the files specified in pathspec using the
  851.           MODEM7 batch Protocol.  Files which cannot be opened are skipped.
  852.           An empty pathspec sends all files in the current directory.  A
  853.           directory name expands to all regular files in that directory.
  854.  
  855.           If an error aborts a file transmission (retries exhausted, etc.),
  856.           batch transfers terminate.
  857.  
  858.           EXAMPLE: s7 *.com Sends all *.com files
  859.  
  860.           N.B.: The receiver must be commanded to receive the files.  This
  861.           command is provided for compatibility with traditional programs that
  862.           do not support the superior YMODEM and ZMODEM protocols.
  863.  
  864.           SEE ALSO: MODEM7 batch protocol, Chapter 13.
  865.  
  866.         sb [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified
  867.           in pathspec using True YMODEMTm Protocol.  The pathname, length, and
  868.           modification time of each file are transmitted.  Files which cannot
  869.           be opened are skipped.  An empty pathspec sends all files in the
  870.           current directory.  A directory name expands to all regular files in
  871.           that directory.
  872.  
  873.           If an error aborts a file transmission (retries exhausted, etc.),
  874.           batch transfers terminate.  The sb command will send files with
  875.           SEAlink protocol if the receiving program requests SEAlink.
  876.  
  877.           EXAMPLE: sb -k *.com Sends *.com using 1024 byte packets.
  878.  
  879.           N.B.: The receiver must be commanded to receive the files with an rb
  880.           command.  Unix and OS/2 users: sb command cannot be used to send
  881.           source files that grow after the beginning of transmission.
  882.  
  883.  
  884.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  885.  
  886.  
  887.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  888.         ZCOMM User Manual                                                  136
  889.  
  890.           SEE ALSO: YMODEM protocol, Chapter 13, SEAlink protocol, Chapter 13.
  891.  
  892.         seek offset Iff a transmit file is open as a result of a f, open, or
  893.           read command, position the file read pointer to offset bytes from
  894.           the beginning of the file if offset is positive (or 0), or from the
  895.           end of the file if offest is negative.  "Seek 0" rewinds the file to
  896.           its beginning.
  897.  
  898.           EXAMPLE: open baz; seek -20000; read<ENTER>Home Reviews the last
  899.           20000 bytes of baz.
  900.  
  901.  
  902.           SEE ALSO: open, read, close
  903.  
  904.         send [-options] pathspec Send the files specified in pathspec with the
  905.           Kermit protocol.  The send command sends files to either a Kermit
  906.           server or a regular Kermit program.
  907.  
  908.           EXAMPLE: send -a *.asm
  909.  
  910.  
  911.         set[s|c] [[_]sparam string] Set String parameter sparam to string.  As
  912.           with all ZCOMM strings, the string must be enclosed by double quote
  913.           characters if it contains spaces, tabs, or semicolons.  Character
  914.           escapes must be used to represent special characters, including
  915.           return and linefeed if needed.
  916.  
  917.           An optional leading underscore (_) prepended to sparam causes the
  918.           string to be cleared by the next call command.
  919.  
  920.           EXAMPLE: set mprefix ATDT sets the modem dialing prefix for tone (T)
  921.  
  922.           EXAMPLE: set f8 \PXXXXX Assigns a five character automatically
  923.           generated password (\PXXXXX character escape described in Chapter )
  924.           to function key F8.  Once programmed this way, the F8 key will
  925.           transmit five nonsense characters determined by the xpassword string
  926.           parameter and the remote system's name as stored in the remote
  927.           string parameter by the last call command.
  928.  
  929.  
  930.           EXAMPLE: set _f1 "logout\r" Assigns the string "logout<ENTER>" to F1
  931.           until the next call command.
  932.  
  933.  
  934.           The parameters that may be set with this command are described in
  935.           Chapter 25.  Case is significant in parameter names.
  936.  
  937.           Set without any arguments will display all non empty string
  938.           parameters and their values.  If the v (verbose) numeric parameter
  939.           is non zero, all string parameters are displayed.  The echo and lput
  940.           commands may be used to display string parameters ("echo %svar").
  941.  
  942.  
  943.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  944.  
  945.  
  946.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  947.         ZCOMM User Manual                                                  137
  948.  
  949.           The setc command performs string substitutions and character escape
  950.           expansions on string before storing.  The sets command performs
  951.           string substitutions on string before storing.
  952.           N.B.: Chapter 26 discusses string concatenation.
  953.  
  954.           EXAMPLE: sets s2 "%z1" Assigns the second token (%z1) generated by
  955.           the split command to string parameter s2.
  956.  
  957.  
  958.           If other commands are to follow on the same line, a semicolon must
  959.           be used to separate the commands.
  960.  
  961.           EXAMPLE: set s1 "su"; goto sendit Would be illegal if the ";" were
  962.           left out.
  963.  
  964.  
  965.           A string parameter may be set to empty with set sparam "" (empty
  966.           string enclosed by double quote characters).
  967.  
  968.           EXAMPLE: pv1; set Displays all string parameters, including all Soft
  969.           Keys.
  970.  
  971.  
  972.           EXAMPLE: sets s8 "s9 EQUALS %s9" Substitutes the value of string
  973.           parameter s9 in the argument before assigning it to s8.
  974.  
  975.  
  976.           SEE ALSO: echo, if, keys, reskeys, ALT-K, commands
  977.           N.B.: When defining function keys to be called from within the term
  978.           function, do not use the t or f commands.  Instead use the create or
  979.           open commands to prevent excessive term function recursion.
  980.  
  981.           Assigning a string to a function key with the set command causes
  982.           that string to be sent to the remote when the key is used within the
  983.           term function.  If the string begins with @, the remainder of the
  984.           string is executed as a ZCOMM command.
  985.  
  986.           EXAMPLE: set f3 "@rb" Assigns the rb command to F3.
  987.  
  988.  
  989.         set[s|c] [_]sparam This form of the set command allows strings
  990.           containing double quote (") characters to be defined.
  991.  
  992.           Given with string parameter sparam, but no string, set reads string
  993.           from the next line verbatim, with only the trailing CR/LF removed.
  994.           The line should not begin with a space or tab unless one is required
  995.           for string.  This form may be used for entering strings containing
  996.           double quotes.  If a script is active, the next line is read from
  997.           the current script file, otherwise the user is prompted for it.
  998.           N.B.: This form of the set command cannot be used as the predicate
  999.           of an if command.  The argument should not appear as a label or
  1000.  
  1001.  
  1002.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1003.  
  1004.  
  1005.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1006.         ZCOMM User Manual                                                  138
  1007.  
  1008.           telephone directory entry.
  1009.  
  1010.           EXAMPLE: set outahost
  1011.           @o; pk3; sp 2400; set disks "abcd"; putw "\336ATM0H1\r" Programs
  1012.           outahost to drop DTR ("o"), set 2400 baud, allow disks a,b,c, and d,
  1013.           and send an ATM0H1 (go off hook) command to the modem to busy out
  1014.           the telephone line.
  1015.  
  1016.  
  1017.         setn sparam expression The setn command stores as a decimal number the
  1018.           result of an arithmetic expression consisting of decimal numbers,
  1019.           string variables, the length of string variables denoted with %, and
  1020.           the operators +, -, *, and /.  The expression is evaluated strictly
  1021.           left to right with 32 bit precision.
  1022.  
  1023.           EXAMPLE: setn vv 1+vv
  1024.  
  1025.  
  1026.         set? sparam condition The set?  command stores a decimal number
  1027.           representing the result of a test condition.
  1028.  
  1029.           EXAMPLE: set? s0 S Stores the value of the S test condition
  1030.           (transmission speed) in string variable s0.
  1031.  
  1032.  
  1033.         sleep deci-seconds Sleep causes ZCOMM to pause for the specified
  1034.           tenths of seconds.  This command may be used in a script with one or
  1035.           more put commands to login to a timesharing service.  The presence
  1036.           of a character in the keyboard buffer will cause the sleep command
  1037.           to finish before the specified time.
  1038.  
  1039.           The maximum sleep time is 32000 tenths of seconds.  Applications
  1040.           involving long sleep times may be better handled with the Host
  1041.           Operation callout queue.
  1042.  
  1043.           EXAMPLE: sleep 30 Pauses for 3 seconds.
  1044.  
  1045.  
  1046.         Soft Keys The Soft Keys f5-f12, fs1-fs10, fc1-fc10, fa1-fa10, fins,
  1047.           fdel, fhome, fend, fup, fdown, fleft, fright, fpgup, fpgdn, etc.
  1048.           may be programmed by set commands given in script files, including
  1049.           the "setup" entry in the distribution PHODIR.t file.  The strings or
  1050.           commands assigned to these keys may be displayed with the keys or
  1051.  
  1052.  
  1053.         ______________________________________________________________________
  1054.  
  1055.         15. Because a failed if command would skip to the next line, the
  1056.             argument of the set command, and attempt to execute it as a script
  1057.             line.
  1058.  
  1059.  
  1060.  
  1061.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1062.  
  1063.  
  1064.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1065.         ZCOMM User Manual                                                  139
  1066.  
  1067.           ALT-K command.  To get a current list of the available soft keys
  1068.           (and other string parameters), keyboard the following three
  1069.           commands:
  1070.  
  1071.                pv1
  1072.                >keylist
  1073.                set
  1074.                close; pv0
  1075.  
  1076.         source sourcefile Accept script commands from sourcefile.  The source
  1077.           and call commands may be nested with up to six[16] scripts open at
  1078.           once.
  1079.  
  1080.           If the script has a READ ONLY attribute, ZCOMM is unrestricted
  1081.           during execution of the script.*
  1082.  
  1083.           Command lines in files accessed by the source command must begin
  1084.           with a tab, space, or label.  Goto commands within sourcefile search
  1085.           for labels in the same sourcefile.  Gosub commands within sourcefile
  1086.           access subroutines in the telephone directory accessed by the phones
  1087.           string parameter.
  1088.  
  1089.           EXAMPLE: bud  source /usr/bin/caf/bin/callbud
  1090.           This telephone directory entry pat calls a separate script file
  1091.           containing commands to call a secret system.  Placing this
  1092.           information in a separate file keeps it out of the main telephone
  1093.           directory file, which might be used on a number of computers.
  1094.  
  1095.  
  1096.           SEE ALSO: gosub command
  1097.  
  1098.         SPeed m Set the transmission speed ("baud rate") to m.  If the speed
  1099.           specified is odd, or equal to 110, two stop bits are transmitted;
  1100.           otherwise one stop bit is transmitted.
  1101.  
  1102.           EXAMPLE: speed 1200
  1103.  
  1104.           N.B.: Some older U.S. Robotics modems cannot accept the sustained
  1105.           full speed output ZCOMM is capable of.  Using speed 2350 corrects
  1106.           such a problem with the U.S. Robotics Courier 2400.
  1107.  
  1108.           Some 1200 and 2400 bps modems work better (lower error rate) if the
  1109.           speed is set to slightly less than the nominal 1200 or 2400.  This
  1110.           also applies to communications networks that cannot accept sustained
  1111.  
  1112.  
  1113.         __________
  1114.  
  1115.         16. Deep nesting may require a decrease in circular buffer memory
  1116.             allocation.
  1117.  
  1118.  
  1119.  
  1120.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1121.  
  1122.  
  1123.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1124.         ZCOMM User Manual                                                  140
  1125.  
  1126.           full speed data, and to serial ports whose bit rate clocks are
  1127.           slightly fast.
  1128.  
  1129.           EXAMPLE: speed 1181 Sets the speed to 1181 bits per second with two
  1130.           stop bits.
  1131.  
  1132.  
  1133.           NB: Timesharing minicomputers often transmit from their serial ports
  1134.           data at higher speeds than they can accept.  In extreme cases, a
  1135.           timesharing port that supports interactive operation at 19200 bps
  1136.           may not tolerate file uploads above 2400 bps.
  1137.  
  1138.           NB: Operation at high speeds is affected by the operating system
  1139.           version, device drivers, memory resident software, and the
  1140.           computer's hardware design.  Chapter 34 describes common problems
  1141.           encountered in high speed operation.  The new generation
  1142.           NS16550AN/NS16550FAN serial interface chips with FIFO buffers should
  1143.           be used instead of 8250's or 16450's for best results at high speed.
  1144.           This is imperative if disk caches, special device drivers or TSR
  1145.           programs increase interrupt latency.
  1146.  
  1147.           SEE ALSO: 7e, 7o, 7m, 7s, 8n, 8g modes, handshake command
  1148.  
  1149.         split svar Split (parse) string parameter svar into tokens stored in
  1150.           string parameters z0...z9 using one or more of the characters in
  1151.           string parameter ifs ("Internal Field Separator") to separate the
  1152.           tokens. **
  1153.  
  1154.           EXAMPLE: If string parameter s1 contains "hello there folks" and ifs
  1155.           contains a space and tab, split s1 Assigns "hello" to z0, "there" to
  1156.           z1, and "folks" to z2.
  1157.  
  1158.  
  1159.           EXAMPLE: Let s0 contain "#1234567-This is big-time Parsing", and ifs
  1160.           contain "#1256- ".  The command split s0 Assigns "34" to z0, "7" to
  1161.           z1, "This" to z2, "is" to z3, "big" to z4, "time" to z5, and
  1162.           "Parsing" to z6.
  1163.  
  1164.  
  1165.           SEE ALSO: y0...y127 string parameters, I,i,p test conditions, sets
  1166.           command
  1167.  
  1168.         split svar string ... uses one string for each token generated.  An
  1169.           empty string ("") assigns the rest of svar to the next token.
  1170.           Otherwise, if tokens remain after the strings are exhausted, ifs is
  1171.           used for parsing the remaining tokens.
  1172.  
  1173.           EXAMPLE: If s0 contains "#1234567-This is ZCOMM Parsing", The
  1174.           command split s0 "-" "" Assigns "#1234567" to z0 and "This is ZCOMM
  1175.           Parsing" to z1.
  1176.  
  1177.  
  1178.  
  1179.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1180.  
  1181.  
  1182.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1183.         ZCOMM User Manual                                                  141
  1184.  
  1185.           EXAMPLE: If s0 contains "503-621-3746", The command split s0 "-" "-"
  1186.           Assigns "503" to z0, "621" to z1, and "3746" to z2.
  1187.  
  1188.  
  1189.           SEE ALSO: ss command, scripts, Chapter 99
  1190.  
  1191.         ss svar regular-expression String Split svar according to regular-
  1192.           expression.  ** Regular expressions are described in Chapter 26.
  1193.           The entire matched string (if any) is stored in the z0 string
  1194.           parameter.
  1195.  
  1196.           Matched groups are stored in the z1...z9 string parameters.
  1197.           Parameters which do not receive a matched string or substring are
  1198.           set empty.
  1199.  
  1200.           EXAMPLE: If string parameter s0 contains
  1201.                   From: Captain Midnight To: HBO Inc.
  1202.           then the command      ss s0 "From: (.*) To: (.*)"
  1203.           places "Captain Midnight" in z1 and "HBO Inc." in z2.  In this case,
  1204.           z0 will contain the entire contents of s0.
  1205.  
  1206.  
  1207.           SEE ALSO: split command, regular-expressions Chapter 26
  1208.  
  1209.         st [-options] pathspec Send the files specified in pathspec using the
  1210.           Telink (FIDO) batch Protocol.  The pathname, length, and
  1211.           modification time of each file are transmitted.  Files which cannot
  1212.           be opened are skipped.  An empty pathspec sends all files in the
  1213.           current directory.  A directory name expands to all regular files in
  1214.           that directory.
  1215.  
  1216.           If an error aborts a file transmission (retries exhausted, etc.),
  1217.           batch transfers terminate.
  1218.  
  1219.           EXAMPLE: st *.com Sends *.com
  1220.  
  1221.           N.B.: The receiver must be commanded to receive the files.
  1222.  
  1223.           SEE ALSO: Telink protocol, Chapter 13.
  1224.  
  1225.         sum pathspec Checksums the named text files with an alogrithym
  1226.           compatible with sum(1) on Version 7 Unix (sum -r on System III/V).
  1227.           Carriage returns, and all characters starting with the first
  1228.           instance of CPMEOF (^Z) are excluded.  This processing allows
  1229.           comparison of plain ASCII source files stored on the different
  1230.           systems, but not binary files.  The checksum is printed in octal,
  1231.           followed by a count of 512 byte blocks and bytes read.
  1232.  
  1233.           EXAMPLE: sum *.c Checksums all C source files in the current
  1234.           directory.
  1235.  
  1236.  
  1237.  
  1238.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1239.  
  1240.  
  1241.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1242.         ZCOMM User Manual                                                  142
  1243.  
  1244.           SEE ALSO: crc, wc commands
  1245.  
  1246.         sx [-options] file Send a single file using the Ward Christensen
  1247.           XMODEM or XMODEM-CRC protocol.  The receiving program may request
  1248.           use of a 16 bit CRC, which is more accurate than the default
  1249.           checksum.  DOS/Unix files sent this way will have Control-Z (CPMEOF)
  1250.           garbage characters appended to make the file length a multiple of
  1251.           128.
  1252.  
  1253.           EXAMPLE: sx foo.com
  1254.  
  1255.  
  1256.           EXAMPLE: sx -k foo.com Sends foo.com using 1024 byte blocks
  1257.  
  1258.           N.B.: The receiver must be commanded to receive the file with an rx
  1259.           filename or rc filename command.
  1260.  
  1261.           SEE ALSO: XMODEM, XMODEM-1k, XMODEM-CRC protocols, Chapter 13.
  1262.  
  1263.         sz [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified
  1264.           in pathspec using ZMODEM Protocol.[17]
  1265.           N.B.: If the remote supports ZMODEM AutoDownload, or accepts rz
  1266.           followed by carriage return as a command to receive files with
  1267.           ZMODEM protocol, only the sz command need be given.  Otherwise, the
  1268.           receiver must be commanded to receive the files with an rz command
  1269.           or menu choice.
  1270.  
  1271.           The +, a, b, n, N, r, y, and Z options are sent to the receiving
  1272.           program.  Only one of the a, b, or r options may be specified.  Only
  1273.           one of the +, n, N, or y options may be specified.
  1274.  
  1275.           Each skipped file is counted as an error as indicated by the e test
  1276.           condition and e numeric parameter.  If the q option is used, files
  1277.           skipped as a result of selective file transfers are not counted as
  1278.           errors.
  1279.  
  1280.           The pathname, length, and modification time of each file are
  1281.           transmitted.  Files which cannot be opened are skipped.  An empty
  1282.           pathspec sends all files in the current directory.  A directory name
  1283.           expands to all regular files in that directory.
  1284.  
  1285.           If ONAME=x is given after the options (if any) and before the file
  1286.           name(s), x will be used exactly as given as the COMPLETE destination
  1287.           pathname instead of each file's actual pathname.  It is the sender's
  1288.  
  1289.  
  1290.         __________
  1291.  
  1292.         17. The receiver may use the sz command to send files by uploading an
  1293.             sz command with the zcommand command.
  1294.  
  1295.  
  1296.  
  1297.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1298.  
  1299.  
  1300.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1301.         ZCOMM User Manual                                                  143
  1302.  
  1303.           responsibility to use lower case for x unless the filename is really
  1304.           supposed to be all caps.
  1305.  
  1306.           EXAMPLE: sz -y ONAME=B:/spiked/secret /soviet/sdi/newlaser.doc
  1307.           Results in the destination file secret on drive B: in the /spiked
  1308.           directory.  (Destination directories must exist and be writable).
  1309.  
  1310.  
  1311.           If instead PREFIX=p is given after the options (if any) and before
  1312.           the file name(s), p will be added to the destination pathname(s) as
  1313.           a prefix.  It is the sender's responsibility to use lower case for p
  1314.           unless the prefix is really supposed to be all caps.
  1315.  
  1316.           EXAMPLE: sz -y PREFIX=C:/foobaz/ /biff/bam/aardvark.wak
  1317.           Results in the destination file "C:/foobaz/aardvark.wak"
  1318.  
  1319.  
  1320.           EXAMPLE: sz *.com   Sends all files with a .com extension.
  1321.  
  1322.  
  1323.           EXAMPLE: sz -r ??log Crash Recovery sends only the new data if the
  1324.           receiver has incomplete versions of these files.
  1325.  
  1326.  
  1327.           EXAMPLE: sz -fn src/*.c src/*.h maildir
  1328.           Sends only newer .c and .h files in the src subdirectory, and all
  1329.           new files in the maildir subdirectory.
  1330.  
  1331.  
  1332.           EXAMPLE: zcommand "sz -fn /bin /wp"
  1333.           commands a remote ZCOMM system in Host Operation (unrestricted) to
  1334.           send all new files in the /bin and /wp directories.
  1335.  
  1336.  
  1337.           EXAMPLE: sz -Yn *.c Sends only newer versions of files that already
  1338.           exist at the destination.
  1339.  
  1340.  
  1341.           EXAMPLE: sz -Rf usera Sends all files in the usera directory and all
  1342.           subdirectories thereof.  Directories are not sorted when the R
  1343.           option is used on 16 bit systems.
  1344.  
  1345.           SEE ALSO: ZMODEM protocol, Chapter 13, Options, Chapter 20.
  1346.  
  1347.  
  1348.  
  1349.         szb [-options] [PREFIX=p | ONAME=x] pathspec As above, but "falls
  1350.           back" to YMODEM if the receiver cannot receive files with ZMODEM
  1351.           protocol.  Because of the YMODEM fallback, szb is not as error
  1352.           resistant as the sz command.
  1353.  
  1354.  
  1355.  
  1356.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1357.  
  1358.  
  1359.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1360.         ZCOMM User Manual                                                  144
  1361.  
  1362.         t [-modes] [capturefile] Invokes the term function for conversational
  1363.           access to the remote.  Normally, ZCOMM will remain in the
  1364.           termfunction until the user keyboards F1.
  1365.  
  1366.           If capturefile is specified, any currently opten capture file is
  1367.           closed and capturefile is opened.  A file previously opened by "t
  1368.           file" is not closed by a t command given without an argument.
  1369.  
  1370.           EXAMPLE: t file1 Creates file1 to capture data sent by the remote in
  1371.           interactive conversation.
  1372.  
  1373.  
  1374.           SEE ALSO: create command
  1375.  
  1376.           If a file upload begun by an f or open command were in progress, the
  1377.           upload will resume with the t command subject to the g mode.
  1378.  
  1379.           In host operation, "t file" begins data capture, and received
  1380.           characters are not echoed.  When the remote sends ETX, EOT, or
  1381.           Ctrl-Z, file is closed and the term function exits.
  1382.  
  1383.           EXAMPLE: t comments.txt<ENTER>
  1384.           jabber ... jabber ... Ctrl-Z
  1385.  
  1386.  
  1387.           Optional modes may be enabled to modify the display, storage, or
  1388.           transmission of information.
  1389.  
  1390.           Subcommands available from the term function are explained in
  1391.           Chapter 22.  Characters special to the term function are also
  1392.           described in Chapter 22.
  1393.  
  1394.         tcs M N The local display of ASCII characters can be remapped to suit
  1395.           local requirements with the tcs (Terminal Character Set) command,
  1396.           where M is the incoming character (1 to 127) and N is the desired
  1397.           hardware character 1 to 255.
  1398.  
  1399.           EXAMPLE: tcs 91 146 translates the ASCII [ character to the AE
  1400.           character.
  1401.  
  1402.  
  1403.           The command tcs by itself disables these translations but does not
  1404.           reset the translation table.
  1405.  
  1406.           The command tcs 0 resets the entries in the translation table.
  1407.  
  1408.           SEE ALSO: display command
  1409.  
  1410.         timestamp * Iff a capture file is open, write out the circular buffer.
  1411.           Then write a line containing the remote system name, number of
  1412.           characters transmitted from disk, the number of characters received
  1413.  
  1414.  
  1415.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1416.  
  1417.  
  1418.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1419.         ZCOMM User Manual                                                  145
  1420.  
  1421.           to disk, average characters received per second, [18] the date and
  1422.           time, and the term function status line information (time, modes,
  1423.           etc.) to the file and to the display.
  1424.  
  1425.           EXAMPLE: timestamp; echoc "End: %e Errors"
  1426.              Timestamp: vif 0 127857 97/sec 1342:37 07-09-86
  1427.              01 24 13:42 21:50   28672 2:1200 7e  EhjSt >cis0709.tmp
  1428.              Allsig Ends: 0 Errors
  1429.  
  1430.           The character counts are reset when the corresponding files are
  1431.           opened.
  1432.  
  1433.           SEE ALSO: restime, ALT-E commands, E test condition, t string
  1434.           parameter
  1435.  
  1436.         trs svar string1 string2 String1 and string2 are first processed for
  1437.           character escapes.  Then translate string variable svar from the
  1438.           character set in string1 into the character set in string2.  *
  1439.           Characters in String1 with no corresponding character in String2 are
  1440.           deleted.  Characters in svar not appearing in String1 are not
  1441.           modified.  The "trs" command may not be used in the body of a
  1442.           "while" command.
  1443.  
  1444.           EXAMPLE: trs s0 "\\{}" "/" Changes backslashes to slashes, and
  1445.           removes "{" and "}" characters.
  1446.  
  1447.  
  1448.         TYPe pathspec Type the specified file(s).  This command closes any
  1449.           open transmit file.  ZCOMM automatically detects SQueezed files and
  1450.           prints them in ASCII.* Type pauses/resumes printing with ^S.
  1451.           Keyboarding ^C or Ctrl-Break cancels, and ^X skips to the next file.
  1452.           <Ctrl-Home> clears the screen without pausing, avoiding scrolling.
  1453.  
  1454.           SEE ALSO: browse, list, page commands, Unix b, bro, typ commands
  1455.  
  1456.           EXAMPLE: type *.txt *.doc
  1457.  
  1458.  
  1459.         unrestrict Prompts for a password and unrestricts ZCOMM if the
  1460.           password exactly matches the contents of the unrestrict string
  1461.           parameter.  If unrestrict is empty or the given password does not
  1462.           match in three attempts, the call is immediately terminated.
  1463.           Unrestrict is used in Host Operation by a caller who wishes
  1464.           unrestricted access to ZCOMM's computer to view confidential files
  1465.           or perform maintenance.
  1466.  
  1467.  
  1468.         __________
  1469.  
  1470.         18. Since the last call or restime command.
  1471.  
  1472.  
  1473.  
  1474.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1475.  
  1476.  
  1477.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1478.         ZCOMM User Manual                                                  146
  1479.  
  1480.           EXAMPLE: unrestrict Prompts for a password (to match the unrestrict
  1481.           parameter), then allows three tries to enter it correctly.
  1482.  
  1483.  
  1484.           SEE ALSO: Host operation
  1485.  
  1486.         usq pathspec * Unsqueeze the specified files back to their original
  1487.           form.  If pathspec is empty, ZCOMM checks all files in the current
  1488.           directory and unsqueezes those that are found to be SQueezed.  If
  1489.           pathspec contains the name of a directory, all files in that
  1490.           directory are checked.  Iff a file has not been SQueezed, ZCOMM will
  1491.           complain and proceed to the next file.  ZCOMM checks the first word
  1492.           of the file(s) to determine whether that file is SQueezed.  If the
  1493.           SQueezed file has been encrypted, such as a Demand Upgrade(TM) copy
  1494.           of ZCOMM, ZCOMM will fetch the key file relative to the current
  1495.           directory for use in decrypting.
  1496.           N.B.: The original pathname and the keyfile pathname (if present),
  1497.           stored in the SQueezed file is interpreted relative to the current
  1498.           directory.
  1499.  
  1500.           EXAMPLE: cd /tmp; usq a: Unsqueezes all the SQueezed files on A:,
  1501.           placing the output files relative to /tmp.
  1502.  
  1503.  
  1504.           EXAMPLE: usq ZCOMM.EQE Unsqueezes an encrypted Demand Upgrade(TM)
  1505.           copy of ZCOMM.  The key file (such as yampc08.key) must be in the
  1506.           current directory.
  1507.  
  1508.  
  1509.         videobios N Sets the video BIOS mode to N.  This command is useful for
  1510.           accessing the high resolution super EGA display text modes, such as
  1511.           100 columns by 75 lines corresponding to high resolution 800x600
  1512.           displays.  The $ and # numeric parameters must be separately set to
  1513.           agree with the new BIOS video mode.
  1514.  
  1515.           The action of the video ROM BIOS to specific values depends on the
  1516.           particular EGA/VGA ROM BIOS used.  To support boards using an
  1517.           extended code in the bl register, calculate N = bl + (256 * al).
  1518.  
  1519.           Some codes produce spectacular unpredictable results.  This command
  1520.           is restricted, and is available on medium model DOS flavors only.
  1521.  
  1522.           EXAMPLE: videobios 3 Sets BIOS video mode 3 (80x25).
  1523.  
  1524.  
  1525.           SEE ALSO: V and W numeric parameters
  1526.  
  1527.         w Writes the contents of the circular buffer to the capture file.
  1528.  
  1529.         wait [-mode] Wait activates the term function to search for each
  1530.           pattern that has been defined with the pattern command.  If a file
  1531.  
  1532.  
  1533.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1534.  
  1535.  
  1536.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1537.         ZCOMM User Manual                                                  147
  1538.  
  1539.           has been opened with the create or t file commands, buffer capture
  1540.           continues during the wait command.  If a file upload (inititated by
  1541.           an f file command) was in progress, the upload will resume with the
  1542.           wait command subject to the g mode.
  1543.  
  1544.           Script execution resumes when the wait command returns because of a
  1545.           pattern match, timeout, no carrier detect, or keyboarded F1.  The
  1546.           wait command's pattern search timeout is effective even if no search
  1547.           patterns have been set with the pattern command.
  1548.  
  1549.           SEE ALSO: pattern, put, putw commands, fN mode
  1550.  
  1551.         wc pathspec Counts lines, words, printing characters, and all
  1552.           characters for the specified files.  The totals are then presented.
  1553.           Characters beginning with CPMEOF (^Z) are excluded.[19] The count of
  1554.           printing characters is useful for estimating laser toner and printer
  1555.           ribbon usage.
  1556.  
  1557.           EXAMPLE: wc *.c *.h
  1558.  
  1559.  
  1560.           SEE ALSO: crc, sum commands
  1561.  
  1562.         while condition rest-of-line Scripts must often repeat a command or
  1563.           set of commands while some condition remains true.  The while
  1564.           command executes the command(s) on the rest of the line while
  1565.           condition is true.  Chapter 27 describes testable conditions.  An
  1566.           inadvertently generated while loop may be stopped by keyboarding
  1567.           NUKE (ALT-N).
  1568.           N.B.: The rest of the line must not contain an if command or
  1569.           semicolons separating commands.  While commands may not be nested.
  1570.  
  1571.           EXAMPLE: pat 1 "ogin:";  while !1 put "\r" wait -f1 Repeatedly sends
  1572.           a carriage return until the remote responds with "Login:".[20]
  1573.  
  1574.  
  1575.           EXAMPLE: while "!1&&L<5" put "\r" wait -f1 Works as above, but only
  1576.           tries 5 times.
  1577.  
  1578.  
  1579.  
  1580.         __________
  1581.  
  1582.         19. The line and word counts agree with the Unix word count program,
  1583.             but the character count will differ because of CR characters not
  1584.             stored in most Unix text files.  The Unix word count program does
  1585.             not have a count of printing characters.
  1586.  
  1587.         20. The "L" in "Login" is not searched for on purpose.  On Unix
  1588.             systems, the "l" is not always capitalized.
  1589.  
  1590.  
  1591.  
  1592.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1593.  
  1594.  
  1595.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1596.         ZCOMM User Manual                                                  148
  1597.  
  1598.         x (eXit) Writes and closes any open files, releases ownership of the
  1599.           serial port, then exits to the operating system without
  1600.           disconnecting the phone line.[21] Exit status is the value of the ?
  1601.           numeric parameter.  This command is not allowed if Restricted.
  1602.  
  1603.         xpc ... * The ZCOMMXPC flavor of ZCOMM supports the Tymnet(TM) X.PC
  1604.           link level protocol with the xpc commands.  See a following
  1605.           subchapter of Chapter 19 for a more detailed description of the X.PC
  1606.           packet driver and the xpc commands that control it.
  1607.  
  1608.         zcommandi COMMAND Send COMMAND with ZMODEM protocol, do NOT wait for
  1609.           command completion.
  1610.  
  1611.           EXAMPLE: zcommandi "!make whoopie"
  1612.  
  1613.  
  1614.         zcommandic COMMAND Process COMMAND for string substitutions and
  1615.           character escapes and send with ZMODEM protocol, do NOT wait for
  1616.           command completion.
  1617.  
  1618.         zcommandw COMMAND Send COMMAND to the remote with ZMODEM protocol.
  1619.           ZMODEM assures an error free command upload.  Wait for COMMAND to
  1620.           complete on the remote.  Store the command's exit value in the ?
  1621.           numeric parameter, available to the ?  test condition.
  1622.           N.B.: With the exception of sz, no command that involves the serial
  1623.           port may be the argument of zcommand.
  1624.  
  1625.           EXAMPLE: zcommandw "sz foo.bar" Causes the remote to send a file
  1626.           with ZMODEM protocol.
  1627.  
  1628.  
  1629.           EXAMPLE: zcommandw "!ls -l | sz -a -" Causes a remote Unix system to
  1630.           send a file containing a directory listing to ZCOMM.
  1631.  
  1632.  
  1633.           As a special case, zcommandw with an empty command fetches the
  1634.           remote's disk file system free character count.  This quantity is
  1635.           then available to the R test condition.
  1636.  
  1637.           EXAMPLE: zcommandw ""; if "R>10000" sz hugefile Fetches the free
  1638.           disk space from the remote, and sends hugefile if the destination's
  1639.           free space is greater than 10000 kilobytes.
  1640.  
  1641.  
  1642.  
  1643.  
  1644.         __________
  1645.  
  1646.         21. On some Unix systems, the operating system may alter the state of
  1647.             the serial port after ZCOMM exits.
  1648.  
  1649.  
  1650.  
  1651.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1652.  
  1653.  
  1654.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1655.         ZCOMM User Manual                                                  149
  1656.  
  1657.         zcommandwc COMMAND Process COMMAND for string substitutions and
  1658.           character escapes and send with ZMODEM protocol, wait for command
  1659.           completion.
  1660.  
  1661.         zmodem Used as a prefix to the p command to select the "zmodem"
  1662.           parameters, or by itself to select the ZMODEM protocol for commands
  1663.           which operate in a choice of protocols depending on past history.
  1664.  
  1665.           EXAMPLE: zmodem
  1666.                !!sz *.*
  1667.           Uses ZMODEM to send a command to the remote machine to send all the
  1668.           files in its current directory.
  1669.  
  1670.         _ Enter a diagnostic routine that prints information about each
  1671.           keystroke entered.  Keyboarding LF (Ctrl-Enter) exits the _
  1672.           (underscore) command.  When a key is struck, the scancode, modified
  1673.           scancode, and the shift state are displayed in decimal.  The
  1674.           modified scancode is either the raw scancode as returned by the BIOS
  1675.           or 224 added to the ZCOMM internal code iff the raw scancode equals
  1676.           224.  The ZCOMM internal code for the key (usually the ASCII value)
  1677.           is displayed in octal.  This command may be used for exploring
  1678.           keyboard encoding and preparing alternate keyboard mappings for use
  1679.           with the mk command.
  1680.  
  1681.           SEE ALSO: mk command
  1682.  
  1683.  
  1684.         ![%][~]command Execute command (either a program or a DOS built-in
  1685.           command) as a subprogram.  A leading % (percent sign) processes
  1686.           Command for string parameter substitutions.  See Chapter 19.6 for
  1687.           details on DOS Gateways and Unix Shell Escapes.
  1688.  
  1689.           SEE ALSO: obey command
  1690.  
  1691.  
  1692.         !!host-command Sends the rest of the line (after !!) to a remote
  1693.           ZMODEM program or Kermit server for execution on the server machine.
  1694.           host-command is not processed for string parameters.  This is a
  1695.           convenient alternative to remote host host-command-string
  1696.           particularly if host-command contains spaces.
  1697.  
  1698.         label: A label begins at the first column and ends with a colon.  One
  1699.           or more commands may appear on the same line separated from the
  1700.           label by white space.  A label may have the same name as a directory
  1701.           entry provided the directory entry appears first in the script file.
  1702.           N.B.: a label differs from a directory entry, which doesn't end with
  1703.           a colon.  When ZCOMM encounters the next directory entry in script
  1704.           processing, an automatic "return" is performed.
  1705.  
  1706.           EXAMPLE: if 1 goto cond1
  1707.                echo "Pattern 1 not matched"
  1708.  
  1709.  
  1710.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1711.  
  1712.  
  1713.         Version 17.78 TurboDial 2.35            Universal Line Printer Edition
  1714.         ZCOMM User Manual                                                  150
  1715.  
  1716.           cond1:    echo "processing continues"
  1717.           foosys    speed 2400 666-1234 t
  1718.  
  1719.  
  1720.         :comment A colon as first character in a command causes the rest of
  1721.           the command line to be ignored.  This is also useful for "commenting
  1722.           out" commands in script files.
  1723.  
  1724.           EXAMPLE: : this line does nothing at all
  1725.  
  1726.  
  1727.         ; Semicolon is a command delimiter which may be used in place of
  1728.           RETURN to place multiple commands on a line.  Since commands such as
  1729.           echo, set, sb, pattern, list, and type take an indefinite number of
  1730.           operands, the semicolon must be used to string such commands
  1731.           together.
  1732.  
  1733.           EXAMPLE: sb *.c; off Batch transmits all *.c files, then puts the
  1734.           modem on hook and exits to DOS.
  1735.  
  1736.           Semicolon is not a command delimiter if it is escaped by a backslash
  1737.           or if it appears within a quoted string.
  1738.  
  1739.           EXAMPLE: pat 0 ";" Sets pattern 0 to search for a semicolon.
  1740.  
  1741.           Commands that take a fixed number of arguments may be strung
  1742.           together without a semicolon unless otherwise noted.
  1743.  
  1744.           EXAMPLE: port 1 speed 1200
  1745.  
  1746.  
  1747.         <file Redirects input used by the command prompt and review function.
  1748.           When reading input from file, certain characters are special:
  1749.  
  1750.               ~  Accept the next character verbatim.
  1751.  
  1752.               |  Sleep for one second.
  1753.  
  1754.               '' Double quote echoes succeeding characters to the display with
  1755.                  highlighting until the next double quote is encountered.
  1756.         On end of file, a ^U is returned and input reverts to the keyboard.
  1757.         The file rev on the demonstration disk is a typical file which might
  1758.         be used with the < command.
  1759.  
  1760.         >[>]outfile Redirects output from succeeding utility commands and
  1761.           debug output (if the v numeric parameter is non zero) to outfile.
  1762.           Capture from the circular buffer is also enabled, but there is no
  1763.           automatic writing of the circular buffer to the file on close.
  1764.           >>outfile appends to outfile.  The output redirection is canceled by
  1765.           the close command or by > without a filename.  DOS predefined device
  1766.           names such as "prn" may be used.
  1767.  
  1768.  
  1769.         (C) 1990 Omen Tech Inc                        Chapter 19 Main Commands
  1770.  
  1771.